Q1: | Is information during program execution output to logs? Where are the logs stored? |
A: |
There are two types of logs output: one is the log for SuperMap iDesktopX, and the other is for SuperMap iObjects, recording information from the desktop and component operations respectively. Log contents include output info from the program's output window, exception details, etc. Logs are stored in the "log" folder under the "bin" directory in the root path. |
Q2: | When using the desktop to access an Oracle data source on a Linux system, why does it fail to open or create, and what is the reason? |
A: | This issue occurs because the Oracle environment variable is not set. The solution is: Before starting SuperMap iDesktopX each time, temporarily set the Oracle client to the environment variable in the Terminal. For example, configure the environment variable via a profile file by adding the following commands to the profile file, then execute "source profile" in the Terminal.
After setting the Oracle client environment variable, restart SuperMap iDesktopX in the same Terminal to use Oracle data sources normally. To create or connect to an Oracle data source, configure the Oracle client in the environment running the desktop, add the client to LD_LIBRARY_PATH. A profile example can be provided, and configure tnsnames.ora. If connecting via EZConnect, tnsnames configuration is unnecessary. |
Q3: | Which version of iObjects Java does the project use? Why can't the develop branch on OSCHINA compile with the latest iObjects downloaded from the official website? |
A: |
The source code in the develop branch depends on an unreleased, in-development version of iObjects Java. Users cannot obtain the newest version of iObjects, leading to compilation errors. It is recommended to fetch the source code from fixed versions in the Tags and download the corresponding iObjects Java version from the SuperMap official website for compilation. |
Q4: | When starting iDesktopX, it fails to launch and prompts "License check failed, please confirm if the license is installed successfully". |
A: |
There are three reasons for this: First, no license is configured; second, the license configuration is unsuccessful; third, the license has expired. For the first two reasons, the solution is to reconfigure the license. Configuration methods differ for Windows and Linux operating systems. Refer to the license configuration sections in Windows Configuration Guide and Linux Configuration Guide for specific steps. |
Q5: | Why does starting SuperMap iDesktopX on SUSE Linux Enterprise 11 SP2 report the error "libSuGraphicsQT.uge:undefined symbol:_ZN40GDC170gdcUnicodeStringC1EPKw"? |
A: |
On SUSE, third-party database clients must be installed to load SDX data engines correctly. Failure to load one SDX engine affects others, preventing any data sources from opening or the program from starting. SDX data engine files requiring third-party database clients include: libSuEngineSRDB.sdx, libSuEngineOracle.sdx, libSuEngineDMCI.sdx, libSuEngineOsp.sdx, libSuEngineAltibase.sdx, libSuEngineDB2.sdx, libSuEngineKDB.sdx. For example: If using an Oracle data source, first install the Oracle client, then delete all *.sdx listed above except libSuEngineOracle.sdx, and restart SuperMap iDesktopX. Similarly, handle other database engines as needed. The solution is: Keep libSuEngineImagePlugin.sdx and the required database engine files in the bin directory of the product package, and delete unnecessary database engine files (the *.sdx in the list above). |
Q6: | An exception is thrown during code compilation and execution. |
A: |
The code on Git has two branches: master and develop. The master branch is the main stable version branch, updated with each stable release. The develop branch is the development branch, updated daily with code modifications but not guaranteed for stability. Therefore, the develop version may throw exceptions. |
Q7: | When running SuperMap iDesktopX on a Linux system, why do fonts in the interface display as squares? |
A: |
This is caused by missing Chinese fonts in the Linux system. Place a Chinese font in the jre/jre/lib/fonts folder under the product package directory, and the program interface text will display normally. |
Q8: | In a Linux system, text labels in the map display abnormally. |
A: |
During map visualization, special fonts like "microsoft yahei" are used, which may not exist in Linux operating systems, causing abnormal display of map annotations and text features. Refer to the attachments fonts_1.zip and fonts_2.zip, which contain mainstream common fonts. When using this program or source code on Linux, download and extract them to the "root directory/support/fonts/" directory (create it if it doesn't exist), and add the environment variable SUPERMAP_ROOT with its value set to "root directory/support/". Then, configure the environment according to 《SuperMap iDesktopX 8C Extension Development Guide.doc》 to display text features normally. |
Q9: | On a Linux system without a Chinese environment, publishing a map service with a Chinese name causes abnormal image display in the browser preview. |
A: |
If Linux lacks a Chinese environment, change the published map name to English; or publish the map service with a Chinese name on a Linux system with a Chinese environment. |
Q10: | When starting iDesktopX, it reports the error: "java.lang.UnsatisfiedLinkError: /opt/SuperMap_iDesktop_Java_8.1.1_bin_linux64/bin/ libWrapjGeo.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.9' not found (required by ./bin/ libSuToolkit.so)" |
A: |
Copy the "libstdc++.so.6" file from the support folder in the desktop package to the Bin directory of the component to resolve this issue. |
Q11: | On a CentOS 5.7 system, when using the SecureCRT.exe terminal tool to remotely access the server, only the command-line interface appears, and iDesktopX cannot start. |
A: |
The desktop startup requires a graphical interface library and can only be launched and operated graphically. First, ensure the remote server has a graphical interface library configured. Second, choose a visual remote connection tool. SecureCRT is a command-line tool; switch to another remote control tool like VNC or Xmanager, both of which allow graphical operations on UNIX or Linux but require configuration. For VNC configuration, refer to How to Configure VNC on CentOS 5.5 and VNC Installation and Configuration. Notes: If encountering this issue on other Linux operating systems, apply the same solution. |
Q12: | Why, after installing SuperMap iDesktopX to system directories like C:\Program Files or C:\Program Files (x86), can the desktop start normally, but some features (e.g., modifying colors, saving layouts to the template library) fail to work? |
A: |
Executing functions like modifying colors or saving layouts to the template library writes data to the installation path. When starting iDesktopX by double-clicking SuperMap iDesktopX.exe, there is no permission to write to system directories, causing the execution to fail. Run SuperMap iDesktopX.exe as an administrator to resolve this. |
Q13: | Why can't SuperMap iDesktopX open data in system directories like C:\, C:\Program Files, or C:\Program Files (x86), nor save images or templates to these directories? |
A: |
When starting iDesktopX by double-clicking SuperMap iDesktopX.exe, there is no permission to read/write data in system directories. Resolve this by:
|
Q14: | When starting SuperMap iDesktopX on a Windows system, it fails to start and reports an error. The error.log indicates "Installation path\SuperMap iDesktopX\bin\WrapjGeo.dll: The specified program could not be found". How to resolve this? |
A: |
This is due to a missing Microsoft Visual C++ runtime. In the support folder under the product installation path \SuperMap\SuperMap iDesktopX, double-click vcredist110_x64.exe. After successfully installing Microsoft Visual C++ 2012, it will start normally. |
Q15: |
On a Windows Server system, starting SuperMap iDesktopX prompts the error shown below. How to resolve this? |
A: |
This is caused by a DLL file failing to load. Resolve it by:
|
Q16: | On a CentOS 5.7 system with JRE version earlier than 1.7, SuperMap iDesktopX fails to start and reports an error. How to resolve this? |
A: |
SuperMap iDesktopX startup requires JRE 1.7 or later. If the JRE version is insufficient, Java fails to start. Solutions include:
Notes: This issue is resolved in version 9D; JRE environment incompatibility no longer prevents startup. |